🦋 Changeset detected

Latest commit: ed81535

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Open in StackBlitz

npm i https://pkg.pr.new/@bomb.sh/tab@139

commit: ed81535

hey @AmirSa12 everything looks sound, i left a tiny nit and also we should consider that this silently changes the dev workflow source <(pnpm tsx cli.ts completezsh) used to work without installing, now the bin needs to be on PATH. fine tradeoff, but worth a line in the changeset or readme so people don't get bitten by it.

The concern about source <(pnpm tsx cli.ts complete zsh) silently breaking is valid in theory, but in practice the recommended dev workflow using a shell function works with both old and new versions of tab.

When you define my-cli() { pnpm tsx src/index.ts "$@"; } and run source <(my-cli complete zsh), the generated completion script binds to my-cli via compdef. When Tab triggers the callback my-cli complete -- ..., the shell resolves it to the function, which forwards all arguments to pnpm tsx. This means no build, no PATH changes, and no installation is needed — the function is session-scoped and disappears when you close the terminal.

This works across all supported shells (zsh, bash, fish, powershell) since eval resolves shell functions in every shell. The only difference is the function definition syntax per shell.

I suggest adding the following dev workflow section to the docs:

Development Workflow

For local development, define a shell function to run the CLI from source. Copy the snippet for your shell:
Replace my-cli with your program name and adjust the source path if needed.

zsh

my-cli() { pnpm tsx src/index.ts "$@"; }
source <(my-cli complete zsh)

bash

my-cli() { pnpm tsx src/index.ts "$@"; }
source <(my-cli complete bash)

fish

function my-cli; pnpm tsx src/index.ts $argv; end
source (my-cli complete fish | psub)

powershell

function my-cli { pnpm tsx src/index.ts $args }
my-cli complete powershell | Out-String | Invoke-Expression

Thank you all!
I'll merge this and change the docs in a separate PR.